<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja" lang="ja">
<head>
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
	<meta http-equiv="Content-Language" content="ja" />
	<meta http-equiv="Content-Style-Type" content="text/css" />
	<meta http-equiv="content-script-type" content="text/javascript" />
	<meta name="Description" content="炊き出したんは炊き出し情報をつぶやくボットです。" />
	<meta name="Keywords" content="炊き出したん,たきだしたん,Hack For Japan" />
	<meta name="robots" content="INDEX,FOLLOW" />
	<title>炊き出したん　仕様書</title>
	<link rel="stylesheet" type="text/css" media="screen,tv" href="css/import.css" />
</head>
<body id="takidasibot">
<div id="container">
	<div id="header">
		<h1><a href="http://twitter.com/takidashitan"><img src="img/title.png" alt="炊き出したん" /></a></h1>

	</div>
	<div id="main" class="clearfix">
		<div id="content">
            <div class="section">
				<h2>概要</h2>
				<p>
				本Twitterアカウント（<a href="http://twitter.com/takidashitan">@takidashitan</a>）は、下記の炊き出し情報のRSSから更新情報を取得しタイムラインにつぶやきます。
				</p>
			<ul>
				<li>宮城版　<a href="http://ow.ly/4dmEm"  target="_blank">http://ow.ly/4dmEm</a> Miyagi</li>
				<li>福島版　<a href="http://ow.ly/4dmBb"  target="_blank">http://ow.ly/4dmBb</a> Fukushima</li>
				<li>茨城版　<a href="http://ow.ly/4dmBu"  target="_blank">http://ow.ly/4dmBu</a> Ibaraki</li>
				<li>栃木版　<a href="http://ow.ly/4dmCk"  target="_blank">http://ow.ly/4dmCk</a> Tochigi</li>
				<li>青森版　<a href="http://ow.ly/4dutZ"  target="_blank">http://ow.ly/4dutZ</a> Aomori</li>
				<li>岩手版　<a href="http://ow.ly/4duvd"  target="_blank">http://ow.ly/4duvd</a> Iwate</li>
				<li>山形版　<a href="http://ow.ly/4dEra"  target="_blank">http://ow.ly/4dEra</a> Yamagata</li>
			</ul>
			<p>
			※注）元になっているデータ（炊き出しまっぷ）は有志の方々によって作成されております。
			「炊き出したん」では、この炊き出しまっぷのRSSを利用している以上，一部古い情報が含まれる可能性もありますのでご注意ください。
			</p>
			</div>
			<div class="section">
				<h2>機能</h2>
				<h3>Twitter検索機能</h3>
				<p>収集の際、更新された情報をデータベースにもっているので次のようなこともできます。</p>
				<p><em>@takidashitan 地名</em></p>
				<p>※注　地名の前にスペースがはいります。</p>
				<p>例 @takidashitan 山形県山形市 上桜田 3-4-5</p>
				<p>このように、炊き出したんにTwitterでメッセージを送ると、
渡された住所から一番近い炊き出しを最大５件まで返事をしてくれます。
（住所から地図の座標を取得しているので一部失敗する住所もあります）
検索の最大範囲は30kmです。</p>
				<h3>範囲検索機能</h3>
				<p>データベースはJSON APIによってアクセスすることができます。</p>
				<p>URL <a href="http://takidasibot.appspot.com/takidasibot/search">http://takidasibot.appspot.com/takidasibot/search</a></p>
				<p>パラメータ</p>
				<dl>
				<dt>lat</dt>
					<dd>latitude　必須</dd>
				<dt>lng</dt>
					<dd>longitude　必須	</dd>
				<dt>m</dt>
					<dd>distance 任意　※炊き出しへの距離メートル（半径）</dd>
				<dt>n</dt>
					<dd>limit 任意　※最大件数</dd>
				<dt>t</dt>
					<dd>出力種別　任意　※json:json形式で出力,jsonp:jsop形式で出力</dd>
				<dt>str1</dt>
					<dd>キーワード検索に使用 任意</dd>
               <dt>callback</dt>
					<dd>コールバック名　任意　※出力種別がjsonp形式に選択されている場合に設定可。
					指定されていない場合はsearch</dd>
				</dl>
				<p>例）HTML<br /><a href="http://takidasibot.appspot.com/takidasibot/search?lat=38.248695&lng=140.910873&m=5000">http://takidasibot.appspot.com/takidasibot/search?lat=38.248695&lng=140.910873&m=5000</a></p>
				<p>出力されるページは次のようになります</p>
				<p>No.1	イズミハウジング IZUMI Housinng(0.00km)<br />
【炊き出し情報元】@takeshikokatsu: <br />
【炊き出し情報】（株）イズミハウジングにて炊き出しを行われています。<br />
【住所Add】<br />
宮城県仙台市若林区大和町２丁目１-２、2-1-2 Yamato-cho, Wakabayashi-ku, Sendai city<br />
No.2	南小泉小学校／給水所(0.65km)<br />
【情報掲載時間】2011.3.13.11:15<br />
【炊き出し情報元】@nhk_seikatsu<br />
: 【炊き出し情報】市立南小泉小学校に給水所が用意されています。<br />
【住所Add】<br />
宮城県仙台市若林区一本杉町１７−１０<br />
022-231-4076</p>
				<p>例）JSON
http://takidasibot.appspot.com/takidasibot/search?lat=38.248695&lng=140.910873&m=5000&t=json</p>
				<p>取得されるデータは次の形式です。</p>
				<dl>
<dt>id</dt>
	<dd>固有ID（元々はRSSに含まれていたuri）</dd>
<dt>distance</dt>
	<dd>距離（パラメータで渡された地点からの距離メートル）</dd>
<dt>latitude</dt>
	<dd>炊き出し地点のlatitude</dd>
<dt>longitude</dt>
	<dd>炊き出し地点のlongitude</dd>
<dt>title</dt>
	<dd>炊き出し地点の名称</dd>
<dt>date</dt>
	<dd>炊き出しの登録された日時</dd>
<dt>description</dt>
	<dd>炊き出しの内容</dd>
</dl>
				<p>例</p>
				<p>[{&quot;id&quot;:&quot;00049e594c4f6c0b407d8&quot;,&quot;title&quot;:&quot;イズミハウジング IZUMI Housinng&quot;,&quot;distance&quot;:0,&quot;description&quot;:&quot;&lt;div dir=\&quot;ltr\&quot;&gt;【炊き出し情報元】@takeshikokatsu: &lt;br&gt;【炊き出し情報】（株）イズミハウジングにて炊き出しを行われています。&lt;br&gt;【住所Add】&lt;br&gt;宮城県仙台市若林区大和町２丁目１-２、2-1-2 Yamato-cho, Wakabayashi-ku, Sendai city&lt;\/div&gt;&quot;,&quot;longitude&quot;:140.910873,&quot;latitude&quot;:38.248695,&quot;date&quot;:&quot;Sun Mar 13 08:51:16 UTC 2011&quot;},{&quot;id&quot;:&quot;00049e594c4f6cfb9cf32&quot;,&quot;title&quot;:&quot;南小泉小学校／給水所&quot;,&quot;distance&quot;:646.4864826348665,&quot;description&quot;:&quot;&lt;div dir=\&quot;ltr\&quot;&gt;【情報掲載時間】2011.3.13.11:15&lt;br&gt;【炊き出し情報元】@nhk_seikatsu&lt;br&gt;: 【炊き出し情報】市立南小泉小学校に給水所が用意されています。&lt;br&gt;【住所Add】&lt;br&gt;\u202a宮城県仙台市若林区一本杉町１７−１０\u202c&lt;br&gt;\u202a022-231-4076&lt;br&gt; \u202c&lt;\/div&gt;&quot;,&quot;longitude&quot;:140.905426,&quot;latitude&quot;:38.244762,&quot;date&quot;:&quot;Sun Mar 13 08:51:16 UTC 2011&quot;},{&quot;id&quot;:&quot;00049e68a80e3ecebbd35&quot;,&quot;title&quot;:&quot;米工房 米夢&quot;,&quot;distance&quot;:964.6731276978793,&quot;description&quot;:&quot;&lt;div dir=\&quot;ltr\&quot;&gt;@narunosuke\u200e 若林区河原町の八百屋さんやスーパー営業中。「米夢」さんはお米や味噌の販売ど、13時からおにぎりを炊き出してくれるそう。（14日正午発言）&lt;\/div&gt;&quot;,&quot;longitude&quot;:140.919235,&quot;latitude&quot;:38.254356,&quot;date&quot;:&quot;Mon Mar 14 03:10:40 UTC 2011&quot;}]</p>
				<h3>単体表示機能</h3>
				<p>つぶやきに表示される炊き出しの情報は、元のRSSをベースにしていますが、１４０文字以上の場合は切りのいいところで切り捨てられます。<br />
情報としては、データベースにもっているため取得をすることも可能です。<br />
最新のバージョンでは、詳細を表示するリンクを付加するようにしました。<br />
詳細の表示は次のようなURIから取得することができます。</p>
				<p><pre>http://takidasibot.appspot.com/takidasibot/view?id=&lt;ID></pre>
※IDは固有ID</p>
				<p>パラメータ</p>
				<dl>
				<dt>id</dt>
					<dd>固有ID　必須</dd>
				<dt>t</dt>
					<dd>出力種別　任意　※json:JSON形式で出力,jsonp:JSONP形式で出力</dd>
				<dt>callback</dt>
					<dd>コールバック名　任意　※出力種別がjsonp形式に選択されている場合に設定可。指定されていない場合はsearch</dd>
				</dl>
				<p>例）<a href="http://takidasibot.appspot.com/takidasibot/view?id=00049e594c4f6c0b407d8">http://takidasibot.appspot.com/takidasibot/view?id=00049e594c4f6c0b407d8</a>
</p>
				<p>実行すると次のようなページが表示されます。</p>
				<p>イズミハウジング IZUMI Housinng<br />
【炊き出し情報元】@takeshikokatsu: <br />
【炊き出し情報】（株）イズミハウジングにて炊き出しを行われています。<br />
【住所Add】<br />
宮城県仙台市若林区大和町２丁目１-２、2-1-2 Yamato-cho, Wakabayashi-ku, Sendai city<br />
(2011.03.13 08:51登録)</p>
				<p>また、この情報はJSONでも取得することが可能です。<br />
その場合は、上記のURLの後ろの t=json を付加してください。</p>
				<p>例）<a href="http://takidasibot.appspot.com/takidasibot/view?id=00049e594c4f6c0b407d8&t=json">http://takidasibot.appspot.com/takidasibot/view?id=00049e594c4f6c0b407d8&t=json</a>
</p>
				<p>結果）</p>
				<p>{&quot;id&quot;:&quot;00049e594c4f6c0b407d8&quot;,&quot;title&quot;:&quot;イズミハウジング IZUMI Housinng&quot;,&quot;description&quot;:&quot;&lt;div dir=\&quot;ltr\&quot;&gt;【炊き出し情報元】@takeshikokatsu: &lt;br&gt;【炊き出し情報】（株）イズミハウジングにて炊き出しを行われています。&lt;br&gt;【住所Add】&lt;br&gt;宮城県仙台市若林区大和町２丁目１-２、2-1-2 Yamato-cho, Wakabayashi-ku, Sendai city&lt;\/div&gt;&quot;,&quot;longitude&quot;:140.910873,&quot;latitude&quot;:38.248695,&quot;date&quot;:&quot;Sun Mar 13 08:51:16 UTC 2011&quot;}</p> 	
				<p>JSONの値</p>
				<dl>
<dt>id</dt>
	<dd>固有ID（元々はRSSに含まれていたuri）</dd>
<dt>latitude</dt>
	<dd>炊き出し地点のlatitude</dd>
<dt>longitude</dt>
	<dd>炊き出し地点のlongitude</dd>
<dt>title</dt>
	<dd>炊き出し地点の名称</dd>
<dt>date</dt>
	<dd>炊き出しの登録された日時</dd>
<dt>description</dt>
	<dd>炊き出しの内容</dd>
</dl>			
			</div>
			<div class="section">
<script type="text/javascript"><!--
google_ad_client = "ca-pub-4906767724811445";
/* 炊き出したん１ */
google_ad_slot = "8809283657";
google_ad_width = 728;
google_ad_height = 90;
//-->
</script>
<script type="text/javascript"
src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
</script>
			</div>
		<!--
	<div id="footer">
	</div>
		-->
		</div>
		<div id="sidebar">
			<!--
            <h2>お知らせ</h2>
            <p>ほげほげ</p>
            -->
			<h2>変更履歴</h2>
            <p><b>4月4日：</b><br />
内部処理を修正<br />
slim3を使用するようにしました。
</p>
            <p><b>3月24日：</b><br />
表示処理を修正<br />
炊き出し詳細表示時のタイムゾーンを日本にしました。
</p>
            <p><b>3月22日：</b><br />
 公式サイト修正<br />
データ元に関する注意事項を追加しました。
</p>
            <p><b>3月21日：</b><br />
公式サイト修正<br />
Hack4Japanにて課題のひとつであった公式サイトの見栄えを修正することに。<br />
まだ、各自治体への説明や、利用者への質問事項などといったことは書いていませんが、トップページを少し見やすくしました。<br />
ありがとうございます。
</p>
            <p><b>3月18日：</b><br />
JSONP対応<br />
お返事用のボットを設定し、API制限がかからないようにローテーションを行うように修正<br />
 searchAPIのLimitの処理できちんとLimitがかかっていなかった不具合を修正</p>
            <p><b>3月17日：</b><br />
最寄りの炊き出し検索の修正ー１００M間隔の間で一番近いものを選択し、その範囲においては登録日付の新しいものを選択するようにしています。<br />
GAEのトラフィックが多くなり、サービスが停止する可能性があったため課金をおこないました。それにあわせてアフェリエイトバナーを追加。<br />
炊き出し検索の詳細取得時のリミットを解除（前までは最大１０件まででした）</p>
		</div>
	</div>
</div>
</body>
</html>
